LAGII 0.1.5 (30 May 1999)
This software is copyright (c) 1998, 1999 XoXus.

The author accepts no responsibility for anything this software may or may
not do to your machine, other software on your machine, yourself, your
family, your friends, or anything else.  There is no guarantee placed on
the software, it's stability, its usefulness in operation, or satisfaction
of the user after using the software.


FIRSTLY:

	Make sure you have a quick skim-read of the FAQ file!


CONTACT:

	XoXus <xoxus@usa.net>


CREDITS:

	* Peter Kelly & Lance Ewing
		The AGI specs
			(http://www.ozemail.com.au/~ptrkelly/agi/specs)
	* Dark Fiber - for some assistance with WeirdStuff(tm)
			(and for the line drawing routine)
		Sarien
			(http://homepages.ihug.com.au/~entropy/agi)


COMPILING:

	Simply type:
		./configure
	Then:
		make depend
	And:
		make
	Finally:
		make install

	Please note that the 'make install' needs to be run as root
	(svgalib needs root permissions to set the video mode). If you
	aren't root when you run 'make install', it will re-run itself
	through su, prompting you for the root password.

	The binaries 'lagii' and 'decomp' are copied to /usr/local/bin
	(or blah/bin if you used ./configure --prefix=blah)

	Easy...


KEYS WHILE RUNNING:

	F11 - Take a screenshot (filename is "xxx-#.gif", where 'xxx' is
		the short title, and '#' is an auto-incrementing number)

	F12 - Instant exit (if this doesn't work, pray)

	PrintScreen - Toggle showing of priority screen

	ScrollLock - Toggle showing of object information

	Pause - Toggle turbo mode

	Page Up - Gives you all inventory items


RUNNING:

	(The binary is created in the 'src' directory, installed by
	default into the /usr/local/bin directory)

	The syntax is:

		lagii [-v] [-h] [-t] [-o] [-d <dump-file>]
			[-i <info-file>] [-l <num>] [-p] <game-dir>

	Where:

	-v	Print version information
	-h	Show help screen
	-t	Turbo mode (quite silly)
	-o	Show object information
	-d	Decompile LOGIC resources to <dump-file> as they are run
	-i	Dump AGI information (a lot) to <info-file>, then exit
	-l	Dump LOGIC <num> to 'logic.dump', then exit
		(this can be decompiled with the 'decomp' utility)
<game-dir>	Directiory holding AGI data files


DECOMPILING

	After obtaining a LOGIC resource through LAGII using the '-l'
	option, you can use the 'decomp' utility ('decomp' directory) to
	decompile it. A couple of quick things about 'decomp':

		(1) It is a filter - you need to pipe in the 'logic.dump'
			file into stdin, and capture stdout
		(2) If 'decomp' just sits at the "Reading in LOGIC....."
			prompt, the input file is not correct. Just hit
			Ctrl+C to stop it.

	An example of a decompilation of, say, LOGIC.0 from KQ2:

	[root@phoenix LAGII-0.1.5]# cd src
	[root@phoenix src]# ./lagii -l 0 /usr/local/games/sierra/kq2/

	----------
	LAGII v0.1.5 - Linux AGI Interpreter
	        (c) 1999 XoXus
	----------

	Dumping LOGIC.0 to 'logic.dump'
	[main]: Game name => Kings Quest 2 (2.2)
	[main]: AGI version => 2.917
	[root@phoenix src]# mv logic.dump ../decomp
	[root@phoenix src]# cd ../decomp
	[root@phoenix decomp]# ./decomp < logic.dump > LOGIC.0
	Reading in LOGIC.....ok! [codesize = 3706]
	[root@phoenix decomp]# ls LOGIC.0 -l
	-rw-r--r--   1 root     root        18242 Apr 29 16:52 LOGIC.0
